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What as Provides 



Scope of This Manual 



Audience 



Further Reading 



This manual is the Programmer’s Reference Manual for as — the assembler for 
the UNIXt system running on the Sun Workstation, as converts source pro- 
grams written in Assembly Language into a form that the linker utility, ld{ 1) will 
turn into a program that is runnable on the UNIX operating system. 

as provides the assembly language programmer with a minimal set of facilities 
to write programs in assembly language. Since most programming is done in 
high-level languages, as doesn’t provide any elaborate macro facilities or con- 
ditional assembly features. It is assumed that the volume of assembly code pro- 
duced is so small that these facilities aren’t required. If they are needed, the C 
preprocessor (see cpp (1)) can be used to provide them. 

This manual describes the syntax and usage of the as assembler for the 
Motorola MC68010 and MC68020 microprocessors and the MC68881 coproces- 
sor. The basic format of as is loosely based on the Digital Equipment 
Corporation’s Macro-1 1 assembler described in DEC’S publication DEC-1 1- 
OMACA-A-D but also contains elements of the UNIX PDP-1 1 as assembler. 
The instruction mnemonics and effective address format are derived from a 
Motorola publication on the MC68000: the MACSS MC68000 Design 
Specification Instruction Set Processor dated June 30, 1979. 

This is a reference manual as opposed to a treatise on writing in assembly 
language. It is assumed that the reader is familiar with the concepts of machine 
architecture, the reasons for an assembler, the ideas of instruction mnemonics, 
operands, and effective address modes, and assembler directives. It is also 
assumed that the reader is familiar with the relevant processors, their instruction 
sets and addressing modes, and especially the irregularities in them. 

Motorola MC68010 16-bit Microprocessor Programmer’s Reference Manual. 
Motorola MC68020 32-bit Microprocessor User’s Manual. 

Motorola MC6888 1 Floating-Point Coprocessor User’s Manual. 



t UNIX is a trademark of AT&T Bell Laboratories. 
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Introduction 



1.1. Using the Assembler By convention, the assembly language source code of the program should be in 

one or more files with a suffix. Suppose that your program is in two files 
called parts. s and rests. To ran the assembler, type the command: 




as runs silently (if there are no errors), and generates a file called a.out. 
as also accepts several command line options. These are: 

-ofile 

Place the output of the assembler in file instead of a.out. 

— m68010 or -10 

Accept only the MC68010 instruction set and addressing modes. This is 
the default on Sun-2 systems. This also puts the MC68010 machine type 
tag into the a.out file. 

— m68020 or -20 

Accept the full MC68020 and MC6888 1 instruction set and addressing 
modes. This includes the MC68010 instruction set and addressing modes 
as a subset, and is the default on Sun-3 systems. This also puts the 
MC68020 machine type tag into the a.out file. 

— O Perform span-dependent instruction resolution over each entire file, rather 
than just over each procedure (see the description of the proc pseudo-op in 
Chapter 5. 

— R Make initialized data segments read-only (actually the assembler places 

them at the end of the .text area). 

— L Keep local (compiler-generated) symbols that start with the letter L. This 

is a debugging feature. If the -L option is omitted, the assembler discards 
those symbols and does not include them in the symbol table. 

— j Make all jumps to external symbols (jsr and jmp) PC-relative rather than 

long-absolute. This is intended for use when the programmer knows that 
the program is short, since it only permits jumps (forward or back) up to 
32K bytes long. If there are any externals which are too far away, the 
loader will complain when the program is linked. 
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-J Suppress span-dependent instruction calculations and force all branches 
and calls to take the most general form. This is used when assembly time 
must be minimized, but program size and mn time are not important. 

-h Suppress span-dependent instruction calculations and force all branches to 
be of medium length, but all calls to take the most general form. This is 
used when assembly time must be minimized, but program size and mn 
time are not important. This option results in a smaller and faster program 
than that produced by the — J option, but some very large programs may 
not be able to use it because of the limits of the medium-length branches. 

-d2 This is intended for small stand-alone programs. The assembler makes all 
program references PC-relative and all data references short-absolute. Note 
that the — j option does half this job anyway. 

-e Allow control sections to begin on any even-numbered byte boundary, 

rather than only multiples of four. Do not use this with programs intended 
for use with the 68020. 

Readers should also consult the UNIX Programmer’s Manual page for the man 

entry on as. 

1.2. Notation The notation used in this manual is a somewhat modified Backus-Naur Form 

(BNF). A string of characters on its own stands for itself, for example: 




is an occurrence of the literal constant 1983. An element enclosed in < and > 
signs is a non-terminal symbol, and must eventually be defined in terms of some 
other entities. For example, 

\ 

<identifier> 

^ J 



stands for the syntactic construct called ‘identifier’, which is eventually defined 
in terms of basic objects. A syntactic object followed by an ellipsis: 



r 


> 


<thing> . . . 




< 


j 



denotes one or more occurrences of <thing>. Syntactic objects occurring one 
after the other, as in: 

— — - . 

<first thing > <second thing > 

. J 

simply means an occurrence of first thing followed by second thing. Syntactic 
elements separated by a vertical bar sign ( | ), as in: 
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mean an occurrence of <letter> or <digit> but not both. Brackets and braces 
define the order of interpretation. Brackets also indicate that the syntax 
described by the subexpression they enclose is optional. That is: 



[ <thing> ] 

\ 

denotes zero or one occurrences of <thing>, while: 

{ <thing one> \ <thing two> } <thing three> 

V 

denotes a <thing one> or a <thing two , followed by a <thing three>. 
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Elements of Assembly Language 

This chapter covers the lexical elements which comprise an assembly language 
program. (Chapter 3 discusses the rules for expression and operand formation.) 
Topics covered in this chapter are: 

□ Character set which the assembler recognizes, 

□ Rules for identifiers and labels, 

□ Syntax for numeric constants, 

□ Syntax for string constants, 

a The assembly location counter. 

An assembly language program is ultimately constructed from characters. Char- 
acters are combined to make up lexical elements or tokens of the language. Com- 
binations of tokens form assembly language statements, and sequences of state- 
ments form an assembly language program. This section describes the basic lexi- 
cal elements of as. 

2.1. Character Set as recognizes the following character set: 

□ The letters A through Z and a through z . 

□ The digits 0 through 9. 

□ The ASCII graphic characters — the printing characters other than letters 
and digits. 

□ The ASCII non-graphics: space, tab, carriage return, and newline (also known 
as linefeed). 

2.2. Identifiers Identifiers are used to tag assembler statements (where they are called labels), as 

location tags for data, and as the symbolic names of constants. 

An identifier in an as program is a sequence of from 1 to 255 characters from 
the set: 

□ Upper case letters A through Z. 

□ Lowercase letters a through z. 

□ Digits 0 through 9. 

#sun 9 

V microsystems 
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□ The characters underline ( _ ), period ( . ), and dollar sign ( $ ). 

The first character of an identifier must not be numeric. Other than that restric- 
tion, there are a few other points to note: 

□ All characters of an identifier are significant and are checked in comparisons 
with other identifiers. 

□ Uppercase letters and lower case letters are distinct, so that 
kit_of_part s and KIT_OF_PARTS are two different identifiers. 

a Although the period ( . ) and dollar sign ( $ ) characters can be used to con- 
struct identifiers, they are reserved for special purposes (pseudo-ops for 
instance) and should not appear in user-defined identifiers. 

Examples of Identifiers 

Grab_Hold Widget Pot_of_Message MAXNAME 



2.3. Numeric Labels A numeric label consists of a digit (0 to 9) followed by a colon. As in the case of 

alphanumeric labels, a numeric label assigns the current value of the location 
counter to the symbol. However, several numeric labels with the same digit may 
be used within the same assembly. References of the form nh refer to the first 
numeric label named n backwards from the reference; nt symbols refer to the 
first numeric label named rt /orwards from the reference. 

2.4. Local Labels Local labels are a special form of identifier which are strictly local to a control 

section (see Section 5.4). Local labels provide a convenient means of generating 
labels for branch instructions and such. Use of local labels reduces the possibil- 
ity of multiply defined labels in a program, and separates entry point labels from 
local references, such as the top of a loop. Local labels cannot be referenced 
from outside the current assembly unit. Local labels are of the form n$ where n 
is any integer. Valid local labels include: 



f 






> 


1 $ 


27 $ 


394 $ 










7 



2.5. Scope of Labels The scope of a label is the ‘distance’ over which it is visible to other parts of the 

program which may reference it. An ordinary label which tags a location in the 
program or data is visible only within the current assembly. An identifier which 
is designated as an external identifier via a . globl directive is visible to other 
assembly units at link time. 

Local labels have a scope, or span of reference, which extends between one ordi- 
nary label and the next. Every time an ordinary label is encountered, all previous 
local labels associated with the current location counter are discarded, and a new 
local label scope is created. The following example illustrates the scopes of the 
different kinds of labels: 
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— 
first : 


addl 


dO , dl | 


\ 

creates a new local label scope 


100$ : 


addqw 

bees 


#7,d3 | 

100$ | 


first appearance of 100$ 
branches to the label above 


second: 


andl 


#0x7ff,d4| 


above 100$ has gone away 


100$ : 


empw 

beqs 


dl, d3 | 

100$ | 


this is a different 100$ 

branches to the previous instruction 


third: 

V 


movw 

beqs 


d0,d7 | 

100$ I 


now 100$ has gone away again 

generates an error message if no 100$ below 

J 



The labels first, second, and third all have a scope which is the entire source file 
containing them. The first appearance of the local label 100$ has a scope which 
extends between first and second. The second appearance of the local label 100$ 
has a scope which extends between second and third. After the appearance of the 
label third, the branch to 100$ will generate an error message because that label 
is no longer defined in this scope. 

2.6. Constants There are two forms of constants available to as users, namely numeric con- 

stants and string constants. All constants are considered absolute quantities 
when they appear in an expression (see Section 3 for a discussion on absolute and 
relocatable expressions). 

2.7. Numeric Constants as assumes that any token which starts with a digit is a numeric constant, as 

accepts numeric quantities in either decimal (base 10), hexadecimal (base 16), or 
octal (base 8) radices. Numeric constants can represent quantities up to 32 bits in 
length. 

Decimal numbers consist of between one and ten decimal digits (0 through 9). 
The range of decimal numbers is between— 2,147,483,648 and 2,147,483,647. 
Note that you can’t have commas in decimal numbers even though they are 
shown here for readability. Note also that decimal numbers can’t be written with 
leading zeros, because a numeric constant starting with a zero is taken as either 
an octal constant or a hexadecimal constant, as described below. 

Hexadecimal constants must start with the notation Ox or OX (zero-ex) and can 
then have between one and eight hexadecimal digits. The hexadecimal digits 
consist of the decimal digits 0 through 9 and the hexadecimal digits a through 
f or A through F. 

Octal constants must start with the digit 0 . There can then be from one to 1 1 
octal digits (0 through 7) in the number. But note that 1 1 octal digits is 33 bits, 
so the largest octal number is 037777777777. 

Floating-point constants must start with #Or or #OR, which may be followed 
by an optional sign and either a number, an infinity or a nan ("not a number"). 
The syntax is 

{#0r | #0R} [+ | -] { <number> | inf | nan} 
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where the syntax of a <number> is 

{ <digits> [. [<digits>] ] \ . <digits>} [E [ + | -] <digits>] 

and <digits> is a string of decimal digits. 

2.8. String Constants A string is a sequence of ASCII characters, enclosed in quote signs 

Within string constants, the quote sign is represented by a backslash character 
followed by a quote sign. The backslash character itself is represented by two 
backslash characters. Any other character can be represented by a backslash 
character followed by one, two, or three octal digits. The table below shows the 
octal representation of some of the more common non-printing characters. 



Character 


Octal 

Representation 


Backspace 


010 


Horizontal Tab 


Oil 


Newline (Linefeed) 


012 


Formfeed 


014 


Carriage Return 


015 



2.9. Assembly Location The assembly location counter is the period character ( . ). It is colloquially 

Counter known as dot. When used in the operand field of any statement, dot represents 

the address of the first byte of the statement. Even in assembler directives, dot 
represents the address of the start of that assembler directive. For example, if dot 
appears as the third argument in a . long directive, the value placed at that 
location is the address of the first location of the directive — dot is not updated 
until the next machine instruction or assembler directive. For example: 



r 






Ralph: movl . ,a0 


I load value of Ralph into aO 




k. ... 




j 



You can reserve storage by advancing dot. For example, the statement 



— 






Table : 


.=.+0x100 




1 




j 



reserves 256 bytes (100 hexadecimal) of storage, with the address of the first byte 
as the value of Table. This is exactly equivalent to using .skip (the preferred 
syntax) as follows: 



r 








Table : 
v . 


. skip 


0x100 


J 
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The value of dot is always relative to the start of the current control section. For 
example, 




doesn’t set dot to absolute location 0x1000, but to location 0x1000 relative to the 
start of the current control section. This practice is not recommended. 
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Expressions 



Expressions are combinations of operands (numeric constants and identifiers) and 
operators, forming new values. The sections below define the operators which 
as provides, then gives the rules for combining terms into expressions. 

3.1. Operators Identifiers and numeric constants can be combined, via arithmetic operators, to 

form expressions, as provides unary operators and binary operators, as 
described below. 

Table 3 - 1 U nary Operators in Expressions 

Operator Function Description 

— unary minus Returns the two’s 

complement of its 
argument. 

logical negation Returns the one’s 
complement 
(logical negation) of 
its argument 




17 
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Table 3-2 Binary Operators in Expressions 



Operator 


Function 


Description 


+ 


addition 


Arithmetic addition 
of its arguments. 


“ 


subtraction 


Arithmetic 
subtraction of its 
arguments. 


★ 


multiplication 


Arithmetic 
multiplication of its 
arguments. 


/ 


division 


Arithmetic division 
of its arguments. 
Note that division 
in as is integer 
division, which 

truncates towards 
zero. 



Each operator works on 32-bit numbers. If the value of a particular term occu- 
pies only 8 bits or 16 bits, it is sign extended to a full 32-bit value. 

3.2. Terms A term is a component of an expression. A term may be any one of the follow- 

ing: 

□ A numeric constant, whose 32-bit value is used. The assembly location 
counter, known as dot, is considered a number in this context. 

□ An identifier. 

□ An expression or term enclosed in parentheses ( ) . Any quantity enclosed 
in parentheses is evaluated before the rest of the expression. This can be 
used to alter the normal left-to-right evaluation of expressions — for exam- 
ple, differentiating between a*b+c and a* (b+c) or to apply a unary 
operator to an entire expression — for example, - (a*b+c ) . 

□ A term preceded by a unary operator. For example, both 
double_plus_ungood and ~double_plus_ungood are terms. 

Multiple unary operators can be used in a term. For example, — posit ive 
has the same value as positive. 



sun 
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3.3. Expressions Expression are combinations of terms joined together by binary operators. An 

expression is always evaluated to a 32-bit value. 

If the operand only requires a single-byte value (a .byte directive or an addq 
instruction, for example) the low-order eight bits of the expression are used. 

If the operand only requires a 16-bit value (a . word directive or a movem 
instruction, for example) the low-order 16 bits of the expression are used. 



Expressions are evaluated left to right with no operator precedence. Thus 




evaluates to 9, not 7. Unary operators have precedence over binary operators 
since they are considered part of a term, and both terms of a binary operator must 
be evaluated before the binary operator can be applied. 

A missing expression or term is interpreted as having a value of zero. In this 
case, an Invalid expression error is generated. 

An Invalid Operator error means that a valid end-of-line character or binary 
operator was not detected after the assembler processed a term. In particular, this 
error is generated if an expression contains an identifier with an illegal character, 
or if an incorrect comment character was used. 

3.4. Absolute, Relocatable, When an expression is evaluated, its value is either absolute, relocatable, or 

and External Expressions external: 

An expression is absolute if its value is fixed. 

□ An expression whose terms are constants is absolute. 

□ An identifier whose value is a constant via a direct assignment statement is 
absolute. 

o A relocatable expression minus a relocatable term is absolute, if both items 
belong to the same program section. 

An expression is relocatable if its value is fixed relative to a base address, but 
will have an offset value when it is linked or loaded into memory. All labels of a 
program defined in relocatable sections are relocatable terms. 

Expressions which contain relocatable terms must only add or subtract constants 
to their value. For example, assuming the identifiers widget and blivet 
were defined in a relocatable section of the program, then the following demon- 
strates the use of relocatable expressions: 



sun 
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Expression 


Description 


widget 


is a simple relocatable term. Its value is an offset from 
the base address of the current control section. 


widget +5 


is a simple relocatable expression. Since the value of 
widget is an offset from the base address of the current 
control section, adding a constant to it does not change 
its relocatable status. 


widget *2 


Not relocatable. Multiplying a relocatable term by a 
constant invalidates the relocatable status. 


2-widget 


Not relocatable, since the expression cannot be linked by 
adding widget’s offset to it. 


widget-bl i vet 


Absolute, since the offsets added to widget and 
blivet cancel each other out. 



An expression is external (or global) if it contains an external identifier not 
defined in the current program. With one exception, the same restrictions on 
expressions containing relocatable identifiers apply to expressions containing 
external identifiers. The exception is that the expression 




is incorrect when both widget and blivet are external identifiers — you 
cannot subtract external relocatable expressions. In addition, you cannot multi- 
ply or divide any relocatable expression. 
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Assembly Language Program Layout 



An as program consists of a series of statements. Several statements can be 
written on one line, but statements cannot cross line boundaries. The format of a 
statement is: 

— 

[< label field >] [ < op-code > [< operand field >] ] 




It is possible to have a statement which consists of only a label field. 

The fields of a statement can be separated by spaces or tabs. There must be at 
least one space or tab separating the op-code field from the operand field, but 
spaces are unnecessary elsewhere. Spaces may appear in the operand field. 
Spaces and tabs are significant when they appear in a character string (for 
instance, as the operand of an .ascii pseudo-op) or in a character constant. In 
these cases, a space or tab stands for itself. 

A line is a sequence of zero or more statements, optionally followed by a com- 
ment, ending with a < newline > character. A line can be up to 4096 characters 
long. Multiple statements on a line are separated by semicolons. Blank lines are 
allowed. The form of a line is: 

. 

[< statement > [ ; < statement >...]][ | < comment > ] 





4.1. Label Field Labels are identifiers which the programmer may use to tag the locations of pro- 

gram and data objects. The format of a < label field> is: 


< identifier > : [ <identifier > : ] . . . 

k 



If present, a label always occurs first in a statement and must be terminated by a 
colon: 




#sun 
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More than one label may appear in the same source statement, each one being 
terminated by a colon: 



r 






presson: grab: hold: 


I multiple labels defined here. 




^ .. - 




j 



The collection of label definitions in a statement is called the label field. 

When a label is encountered in the program, the assembler assigns that label the 
value of the current location counter. The value of a label is relocatable. The 
symbol’s absolute value is assigned when the program is linked via the UNIX 
system linker ld( 1). 

4.2. Operation Code Field The operation code field of an assembly language statement identifies the state- 

ment as either a machine instruction or an assembler directive. 

One or more spaces (or tabs) must separate the operation code field from the fol- 
lowing operand field in a statement. Spaces or tabs are unnecessary between the 
label and operation code fields, but they are recommended to improve readability 
of the program. 

A machine instruction is indicated by an instruction mnemonic. The assembly 
language statement is intended to produce a single executable machine instruc- 
tion. The operation of each instruction is described in the manufacturer’s user 
manual. Some conventions used in as for instruction mnemonics are described 
in Chapter 6 and a complete list of the instructions is presented in Appendix B. 

An assembler directive, or pseudo-op, performs some function during the assem- 
bly process. It does not produce any executable code, but it may assign space for 
data in a program. 

Note that as expects that all instruction mnemonics in the op-code field should 
be in lower case only. Use of any upper case letters in instruction mnemonics 
gives rise to an error message. 

The names of register operands must also be in lower case only. This behavior 
differs from the case of identifiers, where both upper and lower case letters may 
be used and are considered distinct. 

Many MC68010 and MC68020 machine instructions can operate upon byte (8- 
bit), word (16-bit), or long word (32-bit) data. The size which the programmer 
requires is indicated as part of the instruction mnemonic. For instance, a movb 
instruction moves a byte of data, a mo vw instruction moves a 16-bit word of 
data, and a movl instruction moves a 32-bit long word of data. In general, the 
default size for data manipulation instructions is word. 

Many MC6888 1 machine instructions can operate on byte, word or long word 
integer data, on single-precision (32-bit), double-precision (64-bit) or extended- 
precision (96-bit) floating-point data or on packed-decimal (96-bit) data. The 
size required is specified as part of the instruction mnemonic by a trailing "b", 
"w”, ”1", "s”, "d”, "x" or "p", respectively. 

An alternate coprocessor id can be specified for MC6888 1 instructions by 
appending 0 id to the opcode, such as fadd02. If you don’t do this, the 
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coprocessor id specified by the most recent . cpid pseudo-operation is used. 
(See Chapter 5.) 

Similarly, branch instructions can use a long or short offset specifier to indicate 
the destination. So the beq instruction uses a 16-bit offset, whereas the beqs 
uses a short (8-bit) offset. 

Note that this implementation of as provides an extended set of branch instruc- 
tions which start with the letter j instead of the letter b. If the programmer 
uses the j forms, the assembler computes the offset size for the instruction. See 
Section 1.1 for the assembler options which control this. 

4.3. Operand Field The operand field of an assembly language statement supplies the arguments to 

the machine instruction or assembler directive. 

as makes a distinction between the < operand field> and individual < operands > 
in a machine instruction or assembler directive. Some machine instructions and 
assembler directives require two or more arguments, and each of these is referred 
to as an “operand”. 



In general, an operand field consists of zero or more operands, and in all cases, 
operands are separated by commas. In other words, the format for an <operand 
field> is: 



f 




^ 




[ <operand> [ ,<operand> ] . . . ] 




s 




j 



The format of the operand field for machine instructions is the same for all 
instructions, and is described in Chapter 6. The format of the operand field for 
assembler directives depends on the directive itself, and is included in the 
directive’s description in Chapter 6 of this manual. 

Depending upon the machine instmction or assembler directive, the operand field 
consists of one or more operands. The kinds of objects which can form an 
operand are: 

□ Register operands 

□ Register pairs 

□ Address Operands 

□ String constants 

□ Floating-point constants 

□ Register lists 

□ Expressions 

Register operands in a machine instmction refer to the machine registers of the 
processor or coprocessor. 

Note that register names must be in lower case; a s does not recognize register 
names in upper case or a combination of upper case and lower case. 
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Expressions are described in Chapter 3, address operands in Chapter 6, and 
floating-point constants in Chapter 2. 

4.4. Comment Field as provides the means for the programmer to place comments in the source 

code. There are two ways of representing comments. 

A line whose first non-whitespace character is the hash character ( #) is con- 
sidered a comment. This feature is handy for passing C preprocessor output 
through the assembler. For example, these lines are comments: 

( \ 

# This is a comment line. 

# And this one is also a comment line. 

V / 



The other way to introduce a comment is when a comment field appears as a part 
of a statement. The comment field is indicated by the presence of the vertical bar 
character ( | ) after the rest of the source statement. 

The comment field consists of all characters on a source line following and 
including the comment character. The assembler ignores the comment field. 

Any character may appear in the comment field, with the obvious exception of 
the <newline> character, which starts a new line. 



An assembly language source line can consist of just the comment field. For 
example, the two statements below are quite acceptable to the assembler: 



r 


\ 


I This is a comment field. 




| So is this. 




V 


J 



4.5. Direct Assignment 
Statements 



A direct assignment statement assigns the value of an arbitrary expression to a 
specified identifier. The format of a direct assignment statement is: 



r 






<identijier> = 


<expression> 




V 




. J 


Examples of direct assignments are: 








vect_size 


= 4 




vectora 


= OxFFFE 




vectorb 


- vectora-vect_size 




CRLF 


= OxODOA 




dtemp 


= dO I use 


register dO as temporary 






J 



Any identifier defined by direct assignment may be redefined later in the pro- 
gram, in which case its value is the result of the last such statement. This is 
analogous to the SET operation found in other assemblers. 

A local identifier may be defined by direct assignment, though this doesn’t make 
much sense. 
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Register identifiers may not be redefined. 

An identifier which has already been used as a label may not be redefined, since 
this would be tantamount to redefining the address of a place in the program. In 
addition, an identifier which has been defined in a direct assignment statement 
cannot later be used as a label. Both situations give rise to assembler error mes- 
sages. 

If the <expression> is absolute, the identifier is also absolute, and may be treated 
as a constant in subsequent expressions. If the <expression> is relocatable, how- 
ever, the < identifier > is also relocatable, and it is considered to be declared the 
same program section as the expression. 



If the <expression> contains an external identifier, the identifier defined by the = 
statement is also considered external. For example: 



r 




N, 


. globl X 


| X is declared as external identifier 




holder = X 


| holder becomes an external identifier 




V 




J 



assigns the value of X (zero if it is undefined) to holder and makes holder 
an external identifier. External identifiers may be defined by direct assignment. 
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5 



Assembler Directives 



Assembler directives are also known as pseudo operations or pseudo-ops. 
Pseudo-ops are used to direct the actions of the assembler, and to achieve effects 
such as generating data. The pseudo-ops available in as are listed in Table 5- 1 . 

Table 5-1 Assembler Directives 



Pseudo 

Operation 


Description 


.ascii 


Generates a sequence of ascii characters. 


. asciz 


Generates a sequence of ascii characters, terminated by a zero byte. 


.byte 


Generates a sequence of bytes in data storage. 


.word 


Generates a sequence of words in data storage. 


. long 


Generates a sequence of long words in data storage. 


. single 


Generates a sequence of single-precision floating-point constants in 
data storage. 


. double 


Generates a sequence of double-precision floating-point constants in 
data storage. 


.text 


Specifies that generated code be placed in the text control section until 
further notice. 


. data 


Specifies that generated code be placed in the data control section until 
further notice. 


. datal 


Specifies that generated code be placed in the datal control section 
until further notice. 


. data2 


Specifies that generated code be placed in the data.2 control section 
until further notice. 


.bss 


Specifies that space will be reserved in the bss control section until 
further notice. 


. globl 


Declares an identifier as global (external). 


. comm 


Declares the name and size of a common area. 


. lcomm 


Reserves a specified amount of space in the bss area. 
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T able 5-1 Assembler Directives — Continued 



5.1. . ascii — Generate 
Sequence of Character 
Data 



Pseudo 

Operation 


Description 


. skip 


Advances the location counter by a specified amount. 


. align 
. even 


Forces location counter to next one-, two- or four-byte boundary. 
Forces location counter to next word (even-byte) boundary. 


. stab* 


Builds special symbol table entries. These directives are included for 
the benefit of compilers which generate information for the symbolic 
debuggers dbx and dbxtool. 


.proc 


Separates procedures for faster span-dependent instruction resolution. 


. cpid 


Assigns a coprocessor number. 



These assembler directives are discussed in detail in the sections following. 



The .ascii directive translates character strings into their ASCII equivalents 

for use in the source program. The format of the .ascii directive is: 
. 

[<label>:] .ascii "< character string >" 





< character string> 

contains any character or escape sequence which can appear in a 
character string. Obviously, a newline must not appear within the 
character string. A newline can be represented by the escape 
sequence \012. 

The following examples illustrate the use of the . ascii directive: 
Octal Code Generated: Statement: 



150 


145 


154 


154 


157 


040 


.ascii 


"hello there" 


164 


150 


145 


162 


145 








127 


141 


162 


156 


151 


156 


.ascii 


"Warning-\ 00 7 \ 00 7 


147 


055 


007 


007 


040 


012 






141 


142 


143 


144 


145 


146 


. ascii 


"abcdefg" 


147 

















5.2. . asciz — Generate 
Zero-T erminated 
Sequence of Character 
Data 



The .asciz directive is equivalent to the .ascii directive except that a zero 
byte is automatically inserted as the final character of the string. This feature is 
intended for generating strings which C programs can use. 
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The following examples illustrate the use of the . asciz directive: 

Octal Code Generated: 

110 145 154 154 157 040 

127 157 162 144 041 000 

124 150 105 040 107 162 

145 141 164 040 120 122 

117 115 160 153 151 156 

040 163 164 162 151 153 

145 163 040 141 147 141 

151 156 041 000 

5.3. .byte, .word, .long The .byte, .word, .long, . single, and initialize them with 
— Generate Data specified values. 



The format of the various forms of data generation statements is: 



f 

[ < label > : ] 


.byte 


[ <expression> ] [ , <expression> ] . . . 


■\ 


[ <label> : ] 


.word 


[ <expression> ] [ , <expression> ] . . . 




[ <label> : ] 


. long 


[ <expression> ] [ , <expression> ] . . . 




[ < label > : ] 


.single 


[ <expression> ] [ , <expression> ] . . . 




[ < label > : ] 


.double 


[ <expression> ] [ , <expression> ] . . . 




v 






-j 



Statement: 

.asciz "Hello World!" 



.asciz "The Great PROMpkin strikes again 



The . byte directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to the low-order 8 bits of the corresponding 
expression. 

The .word directive reserves one word (16 bits) for each expression in the 
operand field, and initializes it to the low-order 16 bits of the corresponding 
expression. 

The . long directive reserves one long word (32 bits) for each expression in the 
operand field, and initializes it to the value of the corresponding expression. 

The . single directive reserves one long word for each expression in the 
operand field, and initializes it to the low-order 32 bits of the corresponding 
expression. 

The . double directive reserves a pair of long words for each expression in the 
operand field, and initializes them to the value of the corresponding expression. 

Multiple expressions can appear in the operand field of the .byte, .word, 

. long, . single, and . double directives. Multiple expressions must be 
separated by commas. 
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5.4. .text, .data, .bss 

— Switch Location 
Counter 



These statements change the ‘control section’ where assembled code will be 
loaded. 

as (and the UNIX system linker) view programs as divided into three distinct 
sections or address spaces: 

text is the address space where the executable machine instructions are 
placed. 

data is the address space where initialized data is placed. The assembler 

actually knows about three data areas, namely, data, datal, and data2. 
The second and third data areas are mainly for the benefit of the C 
compiler and are of minimal interest to the assembly language pro- 
grammer. 

If the — R option is coded on the as command line, it means that the 
initialized data should be considered read-only. It is actually placed at 
the end of the text area. 

bss is the address space where the uninitialized data areas are placed. Also, 
see the . lcomm directive described below. 

For historical reasons, the different areas are frequently referred to as ‘control 
sections’ (csects for short). 

These sections are equivalent as far as as is concerned, with the exception that 
no instructions or data are generated for the bss section — only its size is com- 
puted and its symbol values are output. 



During the first pass of the assembly, as maintains a separate location counter 
for each section. Consider the following code fragments: 



f 


.text 




| place next instruction 


code : 


movw 


dl, d2 


| in text section 




.data 




| now generate data in 


grab : 


. long 


27 


| data section 




.text 




| now revert to text 


more : 


addw 


d2, dl 


| section 




.data 




| now back to data section 


hold: 


.byte 


4 


_ ...... ^ 



During the first pass, as creates the intermediate output in two separate chunks: 
one for the text section and one for the data section. In the text section, code 
immediately precedes more; in the data section, grab immediately precedes 
hold. At the end of the first pass, as rearranges all the addresses so that the 
sections are sent to the output file in the order: text, data and bss. 

The resulting output file is an executable image file with all addresses correctly 
resolved, with the exception of undefined .globl’s and .comm s. 
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For more information on the format of the assembler’s output file, consult the 
a.out (5) entry in the UNIX System Programmer’s Reference Manual. 

5.5. .skip — Advance the 
Location Counter 



where <size> is the number of bytes by which the location counter should be 
advanced. The .skip directive is equivalent to performing direct assignment 
on the location counter. For instance, a . skip directive like this: 




reserves 1000 bytes of storage, with the value of Table equal to the address of the 
first byte. 



5.6. .lcomm — Reserve The . 1 comm directive is a compact way to get a specific amount of space 

Space in bssArea reserved in the bss area. The format of the . lcomm directive is: 




where <name> is the name of the area to reserve, and <size> is the number of 
bytes to reserve. The . lcomm directive specifically reserves the space in the 
bss area, regardless of which location counter is currently in effect. 



A . lcomm directive like this: 




is equivalent to these directives: 




5.7. . globl — Designate an A program may be assembled in separate modules, and then linked together to 

External Identifier form a single executable unit. See the ld( 1) command in the UNIX Commands 

Reference Manual. 

External identifiers are defined in each of these separate modules. An identifier 
which is defined (given a value) in one module may be referenced in another 
module by declaring it external in both modules. 

There are two forms of external identifiers, namely, those declared with the 
. globl and those declared with the . comm directive. The . comm directive 
is described in the next section. 
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The . skip directive reserves storage by advancing the current location counter 
a specified amount. The format of the . skip directive is: 










36 Assembly Language Reference Manual 



External symbols are declared with the . globl assembler directive. The for- 
mat is: 



. globl <symbol> [ , <symbol> ] . . . 



For example, the following statements declare the array TABLE and the routine 
SRCH as external symbols, and then define them as locations in the current con- 
trol section: 



f 


.globl 


TABLE, SRCH 


TABLE : 


.word 


o 

<N 

o 

•N 

o 

o 

** 

o 


SRCH: 


movw 


TABLE, dO 




etc. 





v > 



5.8. . comm — Define Name 
and Size of a Common 
Area 



The . comm directive declares the name and size of a common area, for compa- 
tibility with FORTRAN and other languages which use common. The format of 
the . comm statement is: 



.comm <name>, <constant expression> 

/ 



where name is the name of the common area, and constant expression is the size 
of the common area. The . comm directive implicitly declares the identifier 
name as an external identifier. 

as does not allocate storage for common symbols; this task is left to the linker. 
The linker computes the maximum declared size of each common symbol (which 
may appear in several load modules), allocates storage for it in the final bss sec- 
tion, and resolves linkages. If, however, <name> appears as a global symbol 
(label) in any module of the program, all references to <name> are linked to it, 
and no additional spaces is allocated in the bss area. 



5.9. .align — Force 
Location Counter to 
Particular Byte 
Boundary 

.align <size> j 



The . align directive advances die location counter to the next one-, two- or 
four-byte boundary, if it is not currently on such a boundary. Intervening bytes 
are filled with zeros. The format of the . align directive is: 



where <size> must be an assembler expression which evaluates to 1, 2 or 4. 

This directive is necessary because word and long word data values must lie on 
even-byte boundaries, because machine instructions must start on even-byte 
boundaries, and because the MC68020 is much more efficient if word and long 
word data are on even-byte and four-byte boundaries, respectively. 
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5.10. 



5.11. 



5 . 12 . 



5.13. 



. even — Force 
Location Counter to 
Even Byte Boundary 



. stabx — Build 
Special Symbol Table 
Entry 



The . even directive advances the location counter to the next even-byte boun- 
dary, if its current value is odd. This directive is necessary because word and 
long word data values must lie on even-byte boundaries, and also because 
machine instructions must start on even-byte boundaries. . even is equivalent 
to .align 2. 

The . stabx directives are provided for the use of compilers which can gen- 
erate information for the symbolic debuggers dbx and dbxtool. The directives 
.stabs, . stabd, and 



.proc — Separate 
Procedures for Span- 
Dependent Instruction 
Resolution 



The . proc directive separates procedures for span-dependent instruction reso- 
lution. In its absence the assembler does span-dependent instruction resolution 
over entire files. If . proc is used, the resolution is done between occurrences 
of the directive and between either end of the file and its nearest occurrences. 
Since the algorithm used requires more than linear time, using . proc can save 
significant time for large assemblies. Branch instructions must not cross . proc 
directives, although calls may. 



. cpid — Name Default 
Coprocessor ID 



The .cpid directive gives the assembler a coprocessor id value to use for 
MC6888 1 instructions that don’t have an explicit coprocessor id given. The 
form of the directive is 



r 




.cpid <id> 




v 


j 



If no . cpid directive is given in a program, a value of 1 is assumed. Since no 
Sun systems currently have more than one coprocessor, you don’t need to use the 
directive. 
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Instructions and Addressing Modes 



This chapter describes the conventions used in as to specify instruction 
mnemonics and addressing modes. The information in this chapter is specific to 
the machine instructions and addressing modes of the MC68010 and MC68020 
microprocessors and the MC6888 1 coprocessor. 

6.1. Instruction Mnemonics The instruction mnemonics which as uses are based on the mnemonics 

described in the relevant Motorola processor manuals. However, as deviates 
from them in several areas. 

Most of the MC68010 and MC68020 instructions can apply to byte, word or long 
operands. Instead of using a qualifier of . b, . w, or .1 to indicate byte, word, 
or long as in the Motorola assembler, as appends a suffix to the normal instruc- 
tion mnemonic, thereby creating a separate mnemonic to indicate which length 
operand was intended. 

For example, there are three mnemonics for the or instruction: orb, orw and 
orl, meaning or byte, or word, and or long, respectively. 

Instruction mnemonics for instructions with unusual opcodes may have addi- 
tional suffixes. Thus in addition to the normal add variations, there also exist 
addqb, addqw and addql for the add quick instruction. 

Branch instructions come in two flavors for the MC68010, byte (or short) and 
word, and an additional flavor, long, for the MC68020. Append the suffix s to 
the word mnemonic to specify the short version of the instruction. For example, 
beq refers to the word version of the Branch if Equal instruction, beqs refers 
to the short version of the instruction, while beql refers to the long version of 
the instruction. 

6.2. Extended Branch In addition to the instructions which explicitly specify the instruction length, a s 

Instruction Mnemonics supports extended branch instructions, whose names are, in most cases, con- 
structed from the word versions by replacing the b with j . 

If the operand of the extended branch instruction is a simple address in the text 
segment, and the offset to that address is sufficiently small, a s automatically 
generates the corresponding short branch instmction. 

If the offset is too large for a short branch, but small enough for a branch, the 
corresponding branch instruction is generated. If the operand references an 
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external address or is complex (see next paragraph), the extended branch instruc- 
tion is implemented either by a jmpor jsr(for jraor jbsr), or (for the 
MC68010) by a conditional branch (with the sense of the condition inverted) 
around a jmp for the extended conditional branches and (for the MC68020) the 
corresponding long branch. 

The extended mnemonics should only be used in the text segment — if they are 
used in the data segment, the most general form of the branch is generated. 

In this context, a complex address is either an address which specifies other than 
normal mode addressing, or a relocatable expression containing more than one 
relocatable symbol. For instance, if a, b and c are symbols in the current seg- 
ment, the expression a+b-c is relocatable, but not simple. 

Consult Appendix B for a complete list of the instruction opcodes. 

63. Addressing Modes The following table describes the addressing modes that as recognizes. Note 

that certain modes are not valid for the MC68010. The notations used in this 
table have these meanings: 

a n refers to an address register, 

d n refers to a data register, 

r i refers to either a data register or an address register, 

ft refers to a floating-point register, 

d refers to a displacement, which is a constant expression in as, 
xxx refers to a constant expression. 

Certain instructions, particularly move accept a variety of special registers 
including: 

sp the stack pointer which is equivalent to a7, 
sr the status register, 

cc the condition codes of the status register, 

usp the user mode stack pointer, 

pc the program counter, 

s f c the source function code register, 

df c the destination function code register, 
fpcr the floating-point control register, 
fpsr the floating-point status register, 

f piar the floating-point iaddr register. 

Note that the 3.0 release of as accepts only the obsolete special register operand 
names fpc for fpcr, fps for fpsr, and fpi for f piar. 
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Table 6- 1 Addressing Modes 



Mode 


Notation 




Example 


Register 


an, dn, sp,pc, cc, sr, usp 


movw 


a3 , d2 


Register Deferred 


a/z@ 


movw 


a30,d2 


Register List 


ri-rj or ri/rj 


movem a0-a4, a60- 


Floating-Point Register 
(MC68881 only) 


fpi 


fmoves fpl , a30 (24) 


Postincrement 


a/iG + 


movw 


a30+, d2 


Predecrement 


an@- 


movw 


a30-, d2 


Displacement 


an6 (d) 


movw 


a30 (24) ,d2 


Word Index 


a n0 (d , r i : w) 


movw 


a30(16, d2 : w) , d3 


Long Index 


an0 (d, ri:l) 


movw 


a30 (16, d2 : 1 ) , d3 


Absolute Short 


xxx:w 


movw 


14 : w, d2 


Absolute Long 


xxx : 1 


movw 


14:1, d2 


PC Displacement 


pc0 (d) 


movw 


pc@ (20) , d3 


PC Word Index 


pc0 (d, ri:w) 


movw 


pc0(14, d2 : w) , d3 


PC Long Index 


pc0 (d , ri:l) 


movw 


pc 0(14, d2 : 1 ) , d3 


Normal 


identifier 


movw 


widget, d3 


Immediate 


$xxx 


movw 


#27+3, d3 



Normal mode assembles as PC-relative if the assembler can determine that this is 
appropriate, otherwise it assembles as either absolute short or absolute long, 
under control of the -d2 command line option. 

The Motorola manuals present different mnemonics (and in fact different forms 
of the actual machine instructions) for instructions that use the literal effective 
address as data instead of using the contents of the effective address. For 
instance, they use the mnemonic adda for add address, as does not make 
these distinctions because it can determine the type of the operand from the form 
of the operand. Thus an instruction of the form: 



/ 

avenue: .word 0 


A 


addl #avenue,aO 


J 


assembles to the add address instmction because 
address register. 


as can determine that aO is an 


right now: = 40000 




addl #right_now, dO 

V 


J 



assembles to an add immediate instmction because as can determine that 
right now is a constant. 
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Because of this determination of operand forms, some of the mnemonics listed in 
the Motorola manuals are missing from the set of mnemonics that as recog- 
nizes. 

Certain classes of instructions accept only subsets of the addressing modes 
above. For example, the add instruction does not accept a PC-relative address as 
a destination, and register lists may be used only with the movem and f movem 
instructions. 

as tries to check all these restrictions and generates the illegal operand error 
code for instructions that do not satisfy the address mode restrictions. 

The next section describes how the address modes are grouped into addressing 
categories. 

6.4. Addressing Categories The processors group the effective address modes into categories derived from 

the manner in which they are used to address operands. Note the distinction 
between address modes and address categories. There are 14 addressing modes 
(18 in the MC68020), and they fall into one or more of four addressing 
categories. The addressing categories are defined here, followed by a table 
which summarizes the grouping of the addressing modes into categories. Note 
that register lists can be used only by the movem and fmovem instructions. 

Data means that the effective address mode is used to refer to data 
operands such as a d register or immediate data. 

Memory means that the effective address mode can refer to memory 

operands. Examples include all the a-register indirect address 
modes and all the absolute address modes. 

Alterable means that the effective address mode refers to operands which are 
writeable (alterable). This category takes in every addressing mode 
except the PC-relative addressing modes and the immediate address 
mode. 

Control means that the effective address mode refers to memory operands 
without any explicit size specification. 

Some addressing categories can be combined to make more restrictive ones. For 
example, the Motorola MC68010 manual mentions the Data Alterable Address- 
ing Mode to mean that the particular instruction can only use those modes which 
provided data addressing and are alterable as well. 
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Table 6-2 Addressing Categories 



Addressing 

Mode 


Assembler 

Syntax 


Data 


Memory 


Control 


Alterable 


Register Direct 


an, d n, sp, pc, 












cc , sr, usp 


X 






X 


A Register Indirect 


a /2 0 


X 


X 


X 


X 


A Register Indirect 
with Post Increment 


a /20 + 


X 


X 




X 


A Register Indirect 
with Pre Decrement 


a n0- 


X 


X 




X 


A Register Indirect 
with Displacement 


an@ (d) 


X 


X 


X 


X 


A Register Indirect 
with Word Index 


a /2 0 (d , r i : w) 


X 


X 


X 


X 


A Register Indirect 
with Long Index 


a/i0 (d, ri : 1) 


X 


X 


X 


X 


Memory Indirect 
Post-Indexed * 


an0 (d, ri : 1) 


X 


X 


X 


X 


Memory Indirect 
Pre-Indexed * 


a /20 (d, ri : 1) 


X 


X 


X 


X 


Absolute Short 


xxx : w 


X 


X 


X 


X 


Absolute Long 


xxx : 1 


X 


X 


X 


X 


PC-relative 


pc0 ( d ) 


X 


X 


X 




PC-relative with 
Word Index 


pc0 (d , ri : w) 


X 


X 


X 




PC-relative 
with Long Index 


pc0 (d, ri : w) 


X 


X 


X 




PC-Memory Indirect 
Post-Indexed * 


a /20 (d, ri : 1) 


X 


X 


X 




PC-Memory Indirect 
Pre-Indexed * 


a /10 (d, ri : 1) 


X 


X 


X 




Immediate Data 


#/2/2/2 


X 


X 







* These addressing categories are not available with the MC68010. 
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Error Codes 



A.l. Usage Errors 



Cannot open output file 

The specified output file cannot be created. Check that the permissions 
allow opening this file. 



Cannot open source file 

The assembler cannot open a specified source file. Check the spelling, that 
the pathname supplied is correct, and that you have read permission for that 
file. 



No input file 

One or more input files must be specified — as cannot acept the output of a 
pipe as its input. 



Too many file names given 

The assembler can not cope with more than one source file. Break the job 
into smaller stages. 

Unknown option V ignored 

as does not recognize the option x. Valid options are listed in Section 1.1. 

A.2. Assembler Error If as detects any errors during the assembly process, it prints out a message of 

Messages the form: 




Error messages are sent to standard error. Here is a list of as error codes, and 
their possible causes. 



Illegal .align 

The expression following a 
2 or 4. 



. align evaluated to some value other than 1 , 
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Invalid assignment 

An attempt was made to redefine a label with an = statement. 



Invalid Character 

An unexpected character was encountered in the program text. 



Invalid Constant 

An invalid digit was encountered in a number. For example, using an 8 or 9 
in an octal number. Also happens when an out-of-range constant operand is 
found in an instruction — for example: 



r 




A 


addq 


#200, d0 




asll 


#12, dO 




v 




y 



Invalid opcode 

The assembler did not recognize an instruction mnemonic. Probably a 
misspelling. 



Invalid operand 

The operand used is not consistent with the instruction used — for example: 



r 


\ 


addqb #l,a5 




\ 


) 



is an invalid combination of instruction and operand. Check the instruction set 
descriptions for valid combinations of instructions and operands. 



Invalid Operator 

Check the operand field for a bad operator. The operators that as recog- 
nizes are plus ( + ), minus ( - ), negate or one’s complement ( " ), multiply 
( * ), and divide ( / ). 



Invalid register expression 

A register name was found where one should not appear — for example: 




Invalid Register List 

The register list in a movem or fmovem instruction was malformed. Note 
that the list must contain more than one register name: to express a list con- 
taining just a single register, you must write its name twice separated by a 
slash, e.g. "fpO/fpO.” 
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Invalid string 

An invalid string was encountered in an . ascii or . asciz directive. 

□ Make sure the string is enclosed in double quotes. 

□ Remember that you must use the sequence \” to represent a double 
quote inside a string. 



Invalid symbol 

An operand that should be a symbol is not — for example: 



.globl 3 

; 



because the constant 3 is not a symbol. 

Invalid Term 

The expression evaluator could not find a valid term: a symbol, constant or 
< expression> . An invalid prefix to a number or a bad symbol name in an 
operand generates this message. 



Line too long 

A statement was found which has more than 4096 characters before the new- 
line character. 



Missing close-par en 

An unmatched ‘(’ was found in an expression. 



Multiply defined symbol 

□ An identifier appears twice as a label. 

□ An attempt to redefine a label using an = (direct assignment) statement. 

□ An attempt to use, as a label, an identifier which was previously defined 
in an = (direct assignment) statement. 

Multiply Defined Symbol ( Phase Error) 

This is a rarely occurring message which indicates an inconsistency in the 
assembler. Report it to Sun Microsystems Technical Support if it occurs. 



N on- relocatable expression 

If an expression contains a relocatable symbol (a label, for instance), the 
only operations that can be applied to it are the addition of absolute expres- 
sions or the subtraction of another relocatable symbol (which produces an 
absolute result). 
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Odd address 

The previous instruction or pseudo-op required an odd number of bytes and 
this instruction requires word alignment. This error can only follow an 
.ascii, an . asciz.a .byte, or a . skip pseudo-operation. 

□ Use a . even directive to ensure that the location counter is forced to a 
16-bit boundary. 



Offset too large 

The instruction is a relative addressing instruction and the displacement 
between this instruction and the label specified is too large for the address 
field of the instruction. 



Out of strings space 

No more room is left in the assembler’s internal string table. Cut the pro- 
gram into smaller portions; assemble portions of the program separately, 
then bind them together using the linker. 



Stab storage exceeded 

No more room is left in the assembler’s symbol table for debug information. 
Cut the program into smaller portions; assemble portions of the program 
separately, then bind them together using the linker. 



Symbol storage exceeded 

No more room is left in the assembler’s symbol table. Cut the program into 
smaller portions; assemble portions of the program separately, then bind 
them together using the linker. 



Symbol Too Long 

A local label reference longer than one digit was found. 



Undefined L-symbol 

This is a warning message. A symbol beginning with the letter ‘L’ was used 
but not defined. It is treated as an external symbol. Compiler-generated 
labels usually start with the letter ‘L’ and should be defined in this assembly. 
The absence of such a definition usually indicates a compiler code genera- 
tion error. This message is also generated by the use of symbols such as $99 
or n$ if n$ has not been defined. 
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Undefined Symbol 

A local label reference to an undefined local label was found. 

Wrong number of operands 

Check Appendix B for the correct number of operands for the current 
instruction. 
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List of as Opcodes 



This appendix is a list of the instruction mnemonics accepted by as, grouped 
alphabetically. The list is divided into two tables, the first covers the MC600x0 
processor’s instuctions, the second covering the MC68881 floating-point 
processor’s instructions. 

Each entry describes the following things: 

□ The mnemonics for the instruction, 

□ The generic name for the instruction, 

□ The assembly language syntax and the variations on the instruction, 

□ Whether the instruction is specific to the MC68020, or has extended capabil- 
ities on the MC68020 compared to the MC68010. 

The syntax for as machine instructions differs somewhat from the instruction 
layouts and categories shown in the Motorola processor manuals. For example, 
as provides a single set of mnemonics for add (add binary), adda (add 
address), and addi (add immediate), differentiated only by the length of the 
operands. In general, as selects the appropriate instruction from the form of the 
operands. 

Here is a brief explanation of the notations used below. 

o An instruction of the form addx in the assembly language syntax column 
means that the instruction is coded as addb or addw or addl, etc. 

□ An operand field of an means any A-register. 

a An operand field of dn means any D-register. 

□ An operand field of r n means any A- or D-register. 

□ An operand field of fn means any floating-point register. 

□ An operand field of ea means an effective address designated by one of the 
permissible addressing modes. Consult the relevant Motorola processor 
manual for details of the allowed addressing modes for each instruction. 

□ An operand field of tidata means an immediate operand. 

a Other special registers such as cc (condition code register) and sr (status 
register) are specifically indicated where appropriate. 
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In the table that follows, the processor is assumed to be the MC68010 unless 
specifically stated otherwise. 



Table B-l List ofMC680xO Instruction Codes 



Mnemonic 


Operation Name 




Syntax 


Processor 


abed 


add decimal with extend 


abed 


dy,dx 








abed 


ay@-, ax0- 




addb 


add binary 


add* 


ea, d n 




addw 




add* 


dn,ea 




addl 




addx 


ea, an 








addx 


%data,ea 




addqb 


add quick 


addqx 


%data , ea 




addqw 










addql 










addxb 


add extended 


addxx 


dy,dx 




addxw 




addxx 


ay@-, ax@- 




addxl 










andb 


logical and 


andx 


ea, dn 




andw 




andx 


dn,ea 




andl 




andx 


§data,ea 




aslb 


arithmetic shift left 


as lx 


dx,dy 




aslw 




a six 


$data, dy 




asll 




aslx 


ea 




asrb 


arithmetic shift right 


asrx 


dx,dy 




asrw 




asrx 


It data, dy 




asrl 




asrx 


ea 




bcc 


branch carry clear 


be ex 


ea 




bccl 








68020 


bees 










bchg 


test a bit and change 


bchg 


dn, ea 








bchg 


%data, ea 




bclr 


test a bit and clear 


bclr 


dn, ea 








bclr 


%data, ea 




bkpt 


breakpoint 


bkpt 


%datafP 


68020 


bset 


test a bit and set 


bset 


dn, ea 








bset 


%data, ea 




btst 


test a bit 


btst 


dn, ea 








btst 


%data, ea 




bf chg 


test a bit field and change 


bf chg 


dn, ea{n,n} 


68020 






bf chg 


%data, ea{n,nj 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


bf clr 


test a bit field and clear 


bf clr 
bf clr 


dn, ea{n,n} 
%data, ea{n,n} 


68020 


bf exts 


extract a bit field signed 


bf ext s d/i , ea{ n,n} 

bf exts %data, ea{n,n} 


68020 


bfextu 


extract a bit field unsigned 


bfextu dn,ea{n t n) 
bfextu Xdata, ea{n,n} 


68020 


bfffo 


find first one in bit field 


bfffo 

bfffo 


dn, ea{n,n} 
%data, ea{n,n } 


68020 


bf ins 


insert a bit field 


bf ins 
bf ins 


d n, ea{n,n } 
%data, ea{n,n } 


68020 


bf set 


test a bit field and set 


bf set 
bf set 


d n, ea{n,n } 
%data, ea{n,n } 


68020 


bftst 


test a bit field 


bftst 

bftst 


dn, ea{n,n } 
%data, ea{n f n} 


68020 


bcs 

bcsl 

boss 


branch carry set 


best 


ea 


68020 


beq 

beql 

beqs 


branch on equal 


beqx 


ea 


68020 


bge 

bgel 

bges 


branch greater or equal 


bger 


ea 


68020 


bgt 

bgtl 

bgts 


branch greater than 


bgtr 


ea 


68020 


bhi 

bhil 

bhis 


branch higher 


bhlx 


ea 


68020 


ble 

blel 

bles 


branch less than or equal 


bier 


ea 


68020 


bis 

blsl 


branch lower or same 


blsx 


ea 


68020 


bit 

bltl 

bits 


branch less than 


bltx 


ea 




broi 


branch minus 


bmir 


ea 
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Table B-l List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


bmil 








bmis 








bne 


branch not equal 


bn ex ea 




bnel 






68020 


bnes 








bpl 


branch positive 


bp lx ea 




bpll 






68020 


bpls 








bra 


branch always 


brax ea 




bral 






68020 


bras 








bsr 


subroutine branch 


bsrx ea 




bsrl 






68020 


bsrs 








bvc 


branch overflow clear 


bvcx ea 




bvcl 






68020 


bvcs 








bvs 


branch overflow set 


bvsx ea 




bvsl 




bvsl 


68020 


bvss 








callm 


call module 


callm data, ea 


68020 


cas2b 


compare & swap with operand 


cas2x del : 6c2 , dul : du2 , (rnl) : (m2) 


68020 


cas21 






68020 


cas2w 






68020 


cash 


compare & swap with operand 


casx dc, du, ea 


68020 


casl 






68020 


casw 






68020 


chk 


check register against bounds 


chk ea, dn 


68020 


chk2b 




chk2x ea, rn 




chk21 








chk2w 








clrb 


clear an operand 


clrx ea 




clrw 








clrl 








cmp2b 


compare register against bounds 


cmp2x ea rn 


68020 


cmp21 






68020 


cmp2w 






68020 


cmpmb 


compare memory 


empmx ay@ + ,ax0+ 




cmpmw 
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Table B - 1 List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


cmpml 


cmpb 


arithmetic compare 


cmpjt 


ea, d n 




cmpw 




cmpx 


$data , ea 




cmpl 










dbcc 


decrement & branch on carry clear 


dbcc 


dn, label 




dbcs 


" on carry set 


dbcs 


d n r label 




dbeq 


" on equal 


dbeq 


dn, label 




dbf 


" on false 


dbf 


dn, label 




dbge 


" on greater than or equal 


dbge 


dn, label 




dbgt 


" on greater than 


dbgt 


dn, label 




dbhi 


" on high 


dbhi 


dn, label 




dble 


" on less than or equal 


dble 


dn, label 




dbls 


*' on low or same 


dbls 


dn, label 




dblt 


M on less than 


dblt 


dn, label 




dbmi 


" on minus 


dbmi 


dn, label 




dbne 


" on not equal 


dbne 


dn, label 




dbpl 


" on plus 


dbpl 


dn, label 




dbra 


" always (same as dbf) 


dbra 


dn, label 




dbt 


” on True 


dbt 


dn, label 




dbvc 


M on overflow clear 


dbvc 


dn, label 




dbvs 


" on overflow set 


dbvs 


dn, label 




divs 


signed divide 


divs 


ea, dn 




divsl 


signed divide 


divsx 


ea, dn 


68020 


divsll 




divsx 


ea, dq 


68020 






divsx 


ea,dr:dq 


68020 


divu 


unsigned divide 


divu 


ea, dn 




divul 


unsigned divide 


divux 


ea, dn 


68020 


divull 




divux 


ea, dq 


68020 






divux 


ea, drzdq 


68020 


eorb 


logical exclusive or 


eorx 


dn, ea 




eorw 




eorx 


$data,ea 




eorl 




eorb 


# data, cc 








eorw 


%data, sr 




exg 


exchange registers 


exg 


tx, ry 




extbl 


sign extend 


extbl 


dn 


68020 


extw 


sign extend 


ext 


dn 




extl 










jmp 


jump 


jmp 


ea 




jsr 


jump to subroutine 


jsr 


ea 




jcc 


jump carry clear 


jcc 


ea 




jcs 


jump on carry 


jcs 


ea 




jeq 


jump on equal 


jeq 


ea 
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Table B-l List ofMC680xO Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


jge 


jump greater or equal 


jge 


ea 




jgt 


jump greater than 


jgt 


ea 




jhi 


jump higher 


jhi 


ea 




jle 


jump less than or equal 


jle 


ea 




jls 


jump lower or same 


jls 


ea 




jit 


jump less than 


jit 


ea 




jmi 


jump minus 


jmi 


ea 




jne 


jump not equal 


jne 


ea 




jpl 


jump positive 


jpi 


ea 




jra 


jump always 


j ra 


ea 




jbsr 


jump to subroutine 


jbsr 


ea 




jvc 


jump no overflow 


jvc 


ea 




jvs 


jump on overflow 


jvs 


ea 




lea 


load effective address 


lea 


ea, an 




link 


link and allocate 


link 


an, %disp 








linkl 


an, tfdisp 


68020 


lslb 


logical shift left 


lslx 


dx,dy 




lslw 




lslx 


tdata , dy 




Isll 




lslx 


ea 




Isrb 


logical shift right 


lsrx 


dx, dy 




lsrw 




lsrx 


%data, dy 




lsrl 




lsrx 


ea 




movb 


move data 


movx 


ea, ea 




movl 










movw 




movx 


%data, dn 




mow 


move from condition code register 


movw 


cc, ea 




movw 


move from status register 


movw 


sr ,ea 




move 


move to control register 


move 


rn, cr 






move from control register 


move 


cr, rn 




moveml 


move multiple registers 


movemx %mask,ea 




movemw 




movemx ea,%mask 








movemx ea , reflist 








movemx reflist f ea 




movepl 


move peripheral 


movepx dn, a n@ ( d ) 




movepw 




movepx dn,an@(d) 




moveq 


move quick 


moveq 


%data, dn 




movsb 


move to address space 


movsx 


rn, ea 




movsw 


move from address space 


movsx 


ea, rn 




movsl 










muls 


signed multiply 


muls 


ea, dn 
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Table B- 1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 


Operation Name 


Syntax 


Processor 


mulsl 




mulsx ea,dl 


68020 






mulsx ea,dh:dl 


68020 


mulu 


unsigned multiply 


mulu ea,dn 




mulul 




mu lux ea,dl 


68020 






mu lux ea,dh:dl 


68020 


nbcd 


negate decimal with extend 


nbcd ea 




negb 


negate binary 


negx ea 




negw 








negl 








negxb 

negxw 

negxl 


negate binary with extend 


negxx ea 




nop 


no operation 


nop 




noth 


logical complement 


not* ea 




notw 








notl 








orb 


inclusive or 


on ea,dn 




orw 




orx dn, ea 




orl 




or %data , ea 

orb %data,cc 
orw %data,sr 




pack 


pack 


pack - (ax) , - (ay) , # adjustment 


68020 






pack dx , dy , # adjustment 


68020 


pea 


push effective address 


pea ea 




reset 


reset machine 


reset 




rolb 


rotate left 


rolx dx, dy 




rolw 




rolx %data, dy 




roll 




rolx ea 




rorb 


rotate right 


rorx dx,dy 




rorw 




rorx %data,dy 




rorl 




rorx ea 




roxlb 


rotate left with extend 


roxlx dx, dy 




roxlw 




roxlx %data, dy 




roxll 




roxlx ea 




roxrb 


rotate right with extend 


roxrx dx, dy 




roxrw 




roxrx %data, dy 




roxrl 




roxrx ea 




rte 


return from exception 


rte 




rtm 


return from module 


rtm r n 


68020 
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Table B-l List ofMC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 




Syntax 


Processor 


rtr 


return and restore codes 


rtr 






rts 


return from subroutine 


rts 










rts 


#n 




sbcd 


subtract decimal with extend 


sbcd 


dy,dx 








sbcd 


ay@-,ax@- 




stop 


halt machine 


stop 


#xxx 




subb 


arithmetic subtract 


suhx 


ea, dn 




subw 




subx 


d n,ea 








suhx 


ea, an 




subl 




suhx 


it data, ea 




st 


set all ones 


st 


ea 




sf 


set all zeros 


sf 


ea 




shi 


set high 


shi 


ea 




sis 


set lower or same 


sis 


ea 




see 


set carry clear 


sec 


ea 




scs 


set carry set 


scs 


ea 




sne 


set not equal 


sne 


ea 




seq 


set equal 


seq 


ea 




SVC 


set no overflow 


SVC 


ea 






set on overflow 


svs 


ea 




spl 


set plus 


spl 


ea 




smi 


set minus 


smi 


ea 




sge 


set greater or equal 


sge 


ea 




sit 


set less than 


sit 


ea 




sgt 


set greater than 


sgt 


ea 




sle 


set less than or equal 


sle 


ea 






subtract quick 


suhqx 


it data, ea 




subqw 




















subxb 


subtract extended 


subxx 


dy, dx 




subxw 




subxx 


a y0-, ax@- 




subxl 










swap 


swap register halves 


swap 


dn 




tas 


test operand then set 


tas 


ea 




trap 


trap 


trap 


# vector 




trapcc 


trap on carry clear 


trapeex 


68020 


trapccl 




trapeex %data 


68020 


trapeew 








68020 


trapes 


trap on carry set 


trapesx 




trapcsl 




trapesx it data 
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Table B - 1 List of MC680xO I nstruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


trapcsw 






68020 


trapeq 


trap on equal 


trapeqx 


68020 


trapeql 




trapeqx %data 


68020 


trapeqw 






68020 


trapf 


trap on never true 


trapf* 


68020 


trapf 1 




trapf* %data 


68020 


trapfw 






68020 


trapge 


trap on greater or equal 


trapge* 




trapgel 




trapge* %data 




trapgew 








trapgt 


trap on greater 


trapgt* 




trapgtl 




trapgt* %data 




trapgrtw 








traphi 


trap on hi 


traphi* 


1 


traphil 




traphi*x %data 




traphiw 








traple 


trap on less or equal 


traple* 




traplel 




traplexx %data 




traplew 








trapls 


trap on low or same 


trapls* 


1 


traplsl 




traplsx %data 


1 


traplsw 








traplt 


trap on less than 


traplt* 


■HUSH 


trapltl 




traplt* #data 




trapltw 








trapmi 


trap on minus 


trapmi* 




trapmil 




trapmi* %data 




trapmiw 








trapne 


trap on not equal 


trapne* 


■ 


trapnel 




trapne* %data 


1 


trapnew 








trappl 


trap on plus 


trappl 


■ 


trappll 




trapplx %datafP 


■ 


trapplw 








trapt 


trap on always true 


trapt 


Mm 


traptl 




traptx tidataflP 


1 


traptw 






■ 


trapv 


trap on overflow 


trapv 




trapvc 


trap on overflow clear 


trapvc 


68020 
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T able B - 1 List of MC680x0 Instruction Codes — Continued 



Mnemonic 


Operation Name 


Syntax 


Processor 


trapvcl 




trap vex bdatafP 




trapvcw 






68020 


trapvs 


trap on overflow set 


trapvs 


68020 


trapvsl 




trapvsx %datafP 


68020 


trapvsw 






68020 


tstb 


test operand 


tstx ea 




tstw 








tstl 








unlk 


unlink 


unlk a n 




unpk 


unpack bed 


unpk - (ax) , -ay) , # adjustment 


1 






unpk dx, dy, # adjustment 


1 



The following table describes the MC6888 1 instuction mnemonics supported by 
as. Each mnemonic indicates the data type that it operates on by the last charac- 
ter of the mnemonic: 

□ b indicates a byte format instruction 

□ w indicates a word format instruction 
o 1 indicates a long format instruction 

□ s indicates a single-word format instruction 

□ d indicates a double-word format instruction 

□ x indicates a n extended format instruction 

□ p indicates a packed format instruction. 



Table B-2 MC6888 1 Instructions supported by as 



Mnemonic 


Operation Name 


Syntax 


fabsx 


absolute value 


fabsx ea, f n 


fabsl 




fabsx f m, fn 


fabss 
fabsp 
fabsw 
fabsd 
f absb 




fabsx fn 


facosx 


arc cosine 


facosx ea, fn 


f acosl 




facosx f m, fn 


facoss 
f acosp 
facosw 




facosx, fn 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 



Operation Name 



Syntax 



facosd 

facosb 



faddx 

faddl 

fadds 

faddp 

faddw 

faddd 

faddb 

fasinx 

fasinl 

fasins 

fasinp 

fasinw 

fasind 

fasinb 

fatanx 

fatanl 

fatans 

fatanp 

fatanw 

fatand 

fatanb 

fatanhx 

fatanhl 

fatanhs 

fatanhp 

fatanhw 

fatanhd 

fatanhb 



arc tangent 



faddx ea , f n 
faddx f m, f n 
faddx f n 



fasinx ea, fn 
fasinx fm, f n 
fasinx fn 



fatanx ea, fn 
fatanx fm, fn 
fatanx fn 



hyperbolic arc tangent 



fatanhx ea, fn 
fatanhx fm, fn 
fatanhx fn 



fb cc 


branch conditionally 


fbcc label 


fbeq 


(equal) 




fbeql 
fbf 
fbf 1 


(false) 




fbgt 

fbgti 


(greater than) 




fble 


(less than or equal) 




fblei 






fblt 


(less than) 




fblti 

fbge 

fbgei 


(greater than or equal) 




♦ 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fbgl 

fbgll 


(greater than or less) 




fbgle 

fbglel 


(greater less or equal) 




fbgt 


(greater than) 




fbne 

fbnel 


(not equal) 




fbneq 

fbneql 


(not (equal)) 




fbnge 

fbngel 


(not greater than or equal) 




fbngl 

fbngll 


(not greater than or less) 




fbngle 

fbnglel 


(not greater than, less or equal) 




fbngt 

fbngtl 


(not greater than) 




fbnle 

fbnlel 


(not less than or equal) 




fbnlt 

fbnltl 


(not less than) 




fbt 

fbtl 


(true) 




fbor 

fborl 


(ordered) 




fboge 

fbogel 


(ordered greater or equal) 




fbogl 

fbogll 


(ordered greater or less) 




fbogt 

fbogtl 


(ordered greater than) 




fbole 

fbolel 


(ordered less or equal) 




fbolt 

fboltl 


(ordered less than) 




fbseq 

fbseql 


(signalling equal) 




fbsf 

fbsfl 


(signalling false) 




fbsne 

fbsnel 


(signalling not equal) 




fbst 

fbstl 


(signalling true) 




fbueq 

fbueql 


(unordered equal) 
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Table B-2 MC6888 1 Instructions supported by a s — Continued 



Mnemonic 


Operation Name 


Syntax 


fbuge 

fbugel 


(unordered greater or equal) 




fbugt 

fbugtl 


(unordered greater than) 




fbule 

fbulel 


(unordered less or equal) 




fbult 

fbultl 


(unordered less than) 




fbun 

fbunl 


(unordered) 




f cmpx 


compare 


fcmpx ea, f n 


fcmpx 
f cmpl 
fcmps 
fcmpp 
fcmpw 
fcmpd 
fcmpb 




fcmpx f m, f n 


fcosx 


cosine 


fcosx ea, f n 


f cosx 




fcosx f m, f n 


fcosl 
fcoss 
fcosp 
fcosw 
f cosd 
fcosb 




fcosx in 


fcoshx 


hyperbolic cosine 


fcoshx ea, in 


fcoshx 




fcoshx im, in 


fcoshl 

fcoshs 

fcoshp 

fcoshw 

fcoshd 

fcoshb 




fcoshx in 


fdbcc 


decrement & branch on condition 


fdbcc d n, label 


fdbeq 


(equal) 




fdbne 


(not equal) 




fdbgt 


(greater than) 




fdbngt 


(not greater than) 




fdbge 


(greater or equal) 




fdbnge 


(not greater or equal) 




fdblt 


(less than) 




fdbnlt 


(not less than) 




fdble 


(less or equal) 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fdbnle 


(not less or equal) 




fdbgl 


(greater or less) 




fdbngl 


(not greater or less) 




fdbgle 


(greater, less or equal) 




fdbngl e 


(not greater, less or equal) 




fdbogt 


(ordered greater than) 




fdbule 


(unordered less or equal) 




fdboge 


(unordered greater or equal) 




fdbult 


(unordered less than) 




fdbolt 


(ordered less than) 




fdbuge 


(unordered greater or equal) 




fdbole 


(ordered less or equal) 




fdbugt 


(unordered greater than) 




fdbogl 


(ordered greater or less) 




fdbueq 


(unordered equal) 




fdbor 


(ordered) 




fdbun 


(unordered) 




fdbf 


(false) 




fdbt 


(true) 




fdbsf 


(signalling false) 




fdbst 


(signalling true) 




fdbseq 


(signalling equal) 




fdbsne 


(signalling not equal) 




fdivx 


divide 


fdivx ea , f n 


fdivx 

fdivl 

fdivs 

fdivp 

fdivw 

fdivd 

fdivb 




fdivx tm, f n 


fetoxx 


e x 


fetoxx ea, f n 


fetoxx 




fetoxx tm, f n 


fetoxl 

fetoxs 

fetoxp 

fetoxw 

fetoxd 

fetoxb 




fetoxx f n 


fetoxmlx 


e x -1 


fetoxmlx ea, f n 


fetoxmlx 




fetoxmlx tm, f n 


fetoxmll 

fetoxmls 

fetoxmlp 




fetoxmlx f n 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fetoxmlw 

fetoxmld 

fetoxmlb 






fgetexpx 
fgetexpx 
fgetexpl 
fgetexps 
fgetexpp 
fgetexpw 
f getexpd 
fgetexpb 


get exponent 


fgetexpx ea, f n 
fgetexpx fm, fn 
fgetexpx fn 


f get man* 
fgetmanx 
fgetmanl 
fgetmans 
fgetmanp 
fgetmanw 
fgetmand 
fgetmanb 


get mantissa 


fgetmanx ea, fn 
fgetmanx fm, fn 
fgetmanx fn 


fintx 
f inti 
f ints 
fintp 
fintw 
fintd 
f intb 


integer part 


fintx ea, fn 
fintx fm, fn 
fintx fn 


fintrx 
fintrzx 
fintrzl 
fintrzs 
f intrzp 
f intrzw 
f intrzd 
fintrzb 


integer part, round to 0 


fintrx ea, fn 
fintrx fm, fn 
fintrx fn 


flog 10* 
floglOx 
floglOl 
f loglOs 
f loglOp 
floglOw 
floglOd 
floglOb 


lo «10 


floglOx ea, fn 
floglOx fm, fn 
floglOx fn 


flog2x 


log? 


f log2x ea, fn 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


flog2x 
flog21 
f log2s 
flog2p 
f log2w 
f log2d 
f log2b 




flog2x f m, f n 
flog2x tn 


flognx 
flognx 
flognl 
f logns 
flognp 
f lognw 
f lognd 
f lognb 


lQ g e 


flognx ea, f n 
flognx f m, f n 
flognx tn 


flognp lx 
flognplx 
f lognpll 
flognpls 
f lognplp 
f lognplw 
flognpld 
f lognplb 


log e (x+l) 


flognplx ea, tn 
flognplx tm, tn 
flognplx tn 


fmodx 

fmodx 

fmodl 

fmods 

fmodp 

fmodw 

fmodd 

fmodb 


modulo remainder 


fmodx ea, tn 
fmodx tm, tn 


f mo vex 
fmovex 
fmovel 
f moves 
fmovep 
fmovew 
fmoved 
fmoveb 


move fp register 


fmovex ea, tn 
fmovex tm, ea 
fmovex tm, ea{ dn 
fmovex tm, ea{#k 


fmovecrx 

fmovecrx 

fmovecr 


move constant ROM 


fmovecrx %ccc, tn 


fmovemx 


move multiple data registers 


fmovemx ea, list 
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Table B-2 MC68881 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


fmovemx 

fmoveml 

fmovem 




fmovemx list, ea 
fmovemx ea, dn 
fmovemx dn, ea 


fmulx 

fmull 

fmuls 

fmulp 

fmulw 

fmuld 

fmulb 


multiply 


fmulx ea, f n 
•fmulx f m, f n 


fnegx 

fnegl 

fnegs 

fnegp 

fnegw 

fnegd 

fnegb 


negate 


fnegx ea, f n 
fnegx f m, f n 
fnegx In 


fnop 


no operation 


fnop 


fremx 
f remx 
freml 
f rems 
f remp 
f remw 
f remd 
f remb 


IEEE remainder 


fremx ea, In 
fremx f m, f n 


f restore 


restore internal state 


frestore ea 


f save 


save internal state 


fsave ea 


f scaler 
f scalex 
f scalel 
f scales 
f scalep 
f scalew 
f scaled 
f scaleb 


scale exponent 


fscalex ea, f n 
fscalex f m, f n 


f sgldivx 
f sgldivx 
f sgldivs 
f sgldivl 
f sgldivp 
f sgldivw 


single-precision divide 


f sgldivx ea, f n 
fsgldivx f m, f n 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


f sgldivb 






f sglmulx 
f sglmulx 
f sglnruls 
fsglmull 
f sglmulp 
fsglmulw 
f sglmulb 


single-precision multiply 


f sglmulx ea, f n 


f sinx 
fsinx 
f sinl 
f sins 
f sinp 
fsinw 
fsind 
f sinb 


sin 


fsinx ea, fn 
fsinx f m, fn 
fsinx fn 


fsincosx 
f sincosx 
f sincosl 
f sincoss 
f sincosp 
fsincosw 
fsincosd 
f sincosb 


simultaneous sine and cosine 


f sincosx ea, fc:l 
f sincosx f m, f c: 


fsinhx 
fsinhl 
fsinhs 
f sinhp 
f sinhw 
fsinhd 
f sinhb 


hyperbolic sine 


fsinhx ea, fn 
fsinhx f m, fn 
fsinhx fn 


f sqrtx 
f sqrtx 
f sqrtl 
f sqrts 
f sqrtp 
f sqrtw 
fsqrtd 
f sqrtb 


square root 


f sqrtx ea, fn 
f sqrtx f m, fn 
f sqrtx fn 


fsubx 
fsubx 
f subl 
fsubs 


subtract 


fsubx ea, fn 
fsubx fm, fn 



#sun 

V microsystems 








Appendix B — List of as Opcodes 75 



Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


f subp 
f subw 
f subd 
f subb 






ftanx 


tangent 


ftanx ea, fn 


ftanx 




ftanx fm, f n 


ftanl 
ftans 
ftanp 
ft anw 
ftand 
ftanb 




ftanx f n 


ftanhx 


hyperbolic tangent 


ftanhx ea, fn 


ftanhx 




ftanhx fm, fn 


ftanhl 

ftanhs 

ftanhp 

ftanhw 

ftanhd 

ftanhb 




ftanhx fn 


ftentoxx 


10 x 


ftentoxx ea, fn 


ftentoxx 




ftentoxx fm, fn 


ftentoxl 

ftentoxs 

ftentoxp 

ftentoxw 

ftentoxd 

ftentoxb 




ftentoxx fn 


ftrapcc 


trap conditionally 


ft rapcc 


ftrapeq 

ftrapeqw 

ftrapeql 


(equal) 


ftrapcc XdalafP 


ftrapne 

ftrapnew 

ftrapnel 


(not equal) 




ftrapgt 

ftrapgtw 

ftrapgtl 


(greater than) 




ftrapngt 

ftrapngtw 

ftrapngtl 


(not greater than) 




ftrapge 

ftrapgew 

ftrapgel 


(greater or equal) 










76 Assembly Language Reference Manual 



Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


ft rapnge 
ftrapngew 
ft rapnge 1 


(not greater or equal) 




ftraplt 

ftrapltw 

ftrapltl 


(less than) 




ftrapnlt 
ft rapnltw 
ftrapnltl 


(not less than) 




ftraple 
ft raplew 
ft raplel 


(less than or equal) 




ftrapnle 

ftrapnlew 

ftrapnlel 


(not less than or equal) 




ft rapgl 

ftrapglw 

ftrapgll 


(greater than or less) 




ft rapngl 
ft rapngl w 
ft rapngl 1 


(not greater than or less) 




ftrapgle 

ftrapglew 

ftrapglel 


(greater, less or equal) 




ftrapngle 
ft rapngl ew 
ftrapnglel 


(not greater, less or equal) 




ftrapogt 

ftrapogtw 

ftrapogtl 


(ordered greater than) 




ftrapule 

ftrapulew 

ftrapulel 


(unordered less or equal) 




ftrapoge 

ftrapogew 

ftrapogel 


(ordered greater or equal) 




ftrapult 

ftrapultw 

ftrapultl 


(unordered less than) 




ftrapolt 

ftrapoltw 

ftrapoltl 


(ordered less than) 




ftrapuge 

ftrapugew 

ftrapugel 


(unordered greater or equal) 






sun 

microsystems 





Appendix B — List of as Opcodes 77 



Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


ftrapole 

ftrapolew 

ftrapolel 


(ordered less or equal) 




ft rapugt 
ftrapugtw 
ft rapugt 1 


(unordered greater than) 




ftrapogl 

ftrapoglw 

ftrapogll 


(ordered greater or less) 




ftrapueq 
ftrapueqw 
ft rapueql 


(unordered equal) 




ftrapor 
f ftraporw 
ftraporl 


(ordered) 




trapun 

ftrapunw 

ftrapunl 


(unordered) 




ftrapf 
ft rapfw 
ftrapfl 


(false) 




ft rapt 
ftraptw 
ft rapt 1 


(true) 




ftrapsf 

ftraptw 

ftrapsfl 


(signalling false) 




ftrapst 
ft raps fw 
ftrapstl 


(signalling true) 




ftrapseq 
ftrapseqw 
ft rapseql 


(signalling equal) 




ftrapsne 

ftrapsnew 

ftrapsnel 


(signalling not equal) 




ftstr 


test operand 


ftstr ea 


ftstx 
ft stl 
ftsts 
ftstp 
ftstw 
ftstd 
ft stb 
ftestx 




ftstr f m 



sun 

microsystems 






78 Assembly Language Reference Manual 



Table B-2 MC68881 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


ftestl 

ftests 

ftestp 

ftestw 

ftestd 

ftestb 


ftwotoxx 


2 X 


ftwotoxx ea r f n 


ftwotoxx 




ftwotoxx f m f f n 


ftwotoxl 




ftwotoxx fn 


ftwotoxs 






ftwotoxp 






ftwotoxw 






ftwotoxd 






ftwotoxb 






f jcc 


jump on condition 


f jcc label 


f jeq 


(equal) 




f jne 


(not equal) 




f jneq 


(not equal or equal) 




f jgt 


(greater than) 




f jngt 


(not greater than) 




f jge 


(greater or equal) 




f jnge 


(not greater or equal) 




f jit 


(less than) 




f jnlt 


(not less than) 




f jle 


(less or equal) 




f jnle 


(not less or equal) 




fjgl 


(greater or less) 




f jngl 


(not greater or less) 




f jgle 


(greater, less or equal) 




f jngle 


(not greater, less or equal) 




f jogt 


(ordered greater than) 




f jule 


(unordered less or equal) 




f joge 


(ordered greater or equal) 




f jult 


(unordered less than) 




f jolt 


(ordered less than) 




f juge 


(unordered greater or equal) 




f jole 


(ordered less or equal) 




f jugt 


(unordered greater than) 




f jogl 


(ordered greater or less) 




f jueq 


(unordered equal) 




f jor 


(ordered) 




f jun 


(unordered) 




fjf 


(false) 




fjt 


(true) 




f jsf 


(signalling false) 
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Table B-2 MC6888 1 Instructions supported by as — Continued 



Mnemonic 


Operation Name 


Syntax 


f jst 


(signalling true) 




f jseq 


(signalling equal) 




f jsne 


(signalling not equal) 




f see 


set according to condition 


fs cc ea 


f seq 


(equal) 




f sne 


(not equal) 




f sneq 


(not equal or equal) 




f sgt 


(greater than) 




f sngt 


(not greater than) 




f sge 


(greater or equal) 




f snge 


(not greater or equal) 




f sit 


(less than) 




f snlt 


(not less than) 




fsle 


(less or equal) 




f snle 


(not less or equal) 




f sgl 


(greater or less) 




f sngl 


(not greater or less) 




f sgle 


(greater, less or equal) 




f sngle 


(greater, less or equal) 




f sogt 


(not greater, less or equal) 




f sule 


(unordered less or equal) 




f soge 


(ordered greater or equal) 




f suit 


(unordered less than) 




f solt 


(ordered less than) 




f suge 


(unordered greater or equal) 




f sole 


(ordered less or equal) 




f sugt 


(unordered greater than) 




f sogl 


(ordered greater or less) 




f sueq 


(unordered equal) 




f sor 


(ordered) 




f sun 


(unordered) 




fsf 


(false) 




f St 


(true) 




f ssf 


(signalling false) 




f sst 


(signalling true) 




f sseq 


(signalling equal) 




f ssne 


(signalling not equal) 
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